home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Cream of the Crop 11
/
Cream of the Crop 11-1.iso
/
program
/
cpc2.zip
/
CP2.DOC
< prev
next >
Wrap
Text File
|
1995-12-31
|
15KB
|
710 lines
Geist Microsystems CodePrint for C/C++
3.5 CodePrint OPTIONS ARRANGED BY CATEGORY
- Reformatter Options
The options listed below provide control of the CodePrint
reformatting feature.
/A Autoindent /Jn Justification
/Kn Keyword Templates /R Reformat
/S Spaces /Tn Tab Spacing
/Vn Tab Conversion
- Pretty Printer Options
The options listed below in addition to the reformat options
above provide control of the CodePrint pretty printing feature.
/D Doublestrike /E Emphasized
/I Italicized
- Additional Print Control Options
The options listed below provide additional print control.
/Bn Page Breaks /Cn Compressed
/F Flow Lines /Gn Configuration
/H Header /L Line Numbers
/Mn Margin /N Page Numbers
/O Options /Pn Printer Port
/Q Quick Print /Wn Carriage Width
/X Extra Form Feed
User Manual Page 18 of 30
Geist Microsystems CodePrint for C/C++
C o d e P r i n t f o r C / C + +
C h a p t e r 4
C o d e P r i n t F e a t u r e s
4.0 CodePrint FEATURES
This chapter provides additional information about some of the
more useful features of CodePrint.
4.1 REFORMATTER
The /R option should be used when you wish to format source
code. This option cancels all printing options, leaving only
reformatting options toggled on. The /R option is equivalent to
/B0 /D /E /H /I /L /M /N /P-1 /W /X. If you wish to customize
the formatting of your source code, you may use one or more of
the "Reformatter" options listed in section 3.5.
4.2 PRETTY PRINTER
All of the CP options are valid for pretty printing with two
exceptions. You cannot use the /P option or the /R option. The
/P option with an invalid argument cancels printing and the /R
option cancels all of the printing options. If you wish to
customize the pretty printing of your source code, you may use
one or more of the "Pretty Printer" options listed in section
3.5.
4.3 ON-LINE HELP
CodePrint provides you with limited on-line help displaying CP
command syntax and command-line options. To invoke the on-line
help just type:
C> CP
and press ENTER.
User Manual Page 19 of 30
Geist Microsystems CodePrint for C/C++
4.4 BATCH PROCESSING AND PRINT SPOOLING
CodePrint provides you with three methods of batch processing.
First, you may enter more than one file on the command line.
The command line is limited by DOS to 128 bytes. The file names
must be separated by spaces. For example:
C> CP FILE1.C FILE2.C FILE3.C
... or ...
C> CP FILE1.CPP FILE2.CPP FILE3.CPP
Second you may use the "*" and "?" wild cards in your file
specification. For example:
C> CP *.C
... or ...
C> CP *.CPP
... or ...
C> CP FILE?.CPP
... or ...
C> CP FILE?.C
Third, you may process a file listing by entering the file
listing name immediately preceded by the @ symbol. For example:
C> CP @MYFILES.LST
The file must be in standard ASCII format. You may create these
files with any text editor. Each file name must be placed on a
separate line. The number of files you may enter in the file
listing is limited to 100 when you are reformatting source code
and by the size of the print queue when you are printing source
code. You may modify the size of the print queue with the
PRINT /Q:queuesize command. Legal values for queuesize range
from 1 to 32. The default value is 10.
CodePrint makes use of the DOS PRINT spooler. That means you do
not have to wait for the printer to finish before you can
continue to use your computer for other tasks. CodePrint just
loads files to print in the print queue and immediately returns
control of the keyboard to you. However, until the entire queue
has been transfered to the printer, you may experience some
annoying keyboard interrupts as you are typing.
User Manual Page 20 of 30
Geist Microsystems CodePrint for C/C++
4.5 KEYWORD TEMPLATES
The keyword template is list of keywords for a specified
programming language. The templates also contain special
characters that control the auto-indent feature. You are free
to edit the templates. They are provided in ASCII format.
Special characters have been added to the list of keywords for
the purpose of controlling the indenting. Below are samples of
indent symbols and their meanings:
┌───────────┬──────────────────────────────────────────────────┐
│ Symbol │ Meaning │
├───────────┼──────────────────────────────────────────────────┤
│ .> │ Indent right after the line. │
├───────────┼──────────────────────────────────────────────────┤
│ <. │ Indent left before the line. │
├───────────┼──────────────────────────────────────────────────┤
│ <.> │ Indent left before the line and indent right │
│ │ after the line. │
├───────────┼──────────────────────────────────────────────────┤
│ ! │ This keyword is an exception to the indent rule │
│ │ and requires special handling. │
└───────────┴──────────────────────────────────────────────────┘
User Manual Page 21 of 30
Geist Microsystems CodePrint for C/C++
4.5 ERROR MESSAGES
The following is a complete list of error messages. You may
encounter some of them as you process source files with
CodePrint. Corrective actions and/or brief explanations are
provided after each error message.
01. Incorrect DOS version.
CodePrint requires DOS version 3.1 or a later version.
02. Printer not ready.
The printer is not available, not powered on, not on-line
or out of paper.
03. Source file not found: <source file name>.
The source file does not exist.
04. Source code nesting too deep.
CodePrint cannot process source files with nesting deeper
than 20 indent levels.
05. Illegal argument in CP option: /Bn.
The range for legal arguments to the /B option is -1 thru
80.
06. Illegal argument in CP option: /Cn.
The range for legal arguments to the /C option is 0 thru 2.
07. Illegal argument in CP option: /Gn.
The range for legal arguments to the /G option is 0 thru 6.
08. Illegal argument in CP option: /Jn.
The range for legal arguments to the /J option is -138 thru
138.
09. Illegal argument in CP option: /Kn.
The range for legal arguments to the /K option is 0 thru 3.
10. Illegal argument in CP option: /Mn.
The range for legal arguments to the /M option is 0 thru 16.
User Manual Page 22 of 30
Geist Microsystems CodePrint for C/C++
11. Illegal argument in CP option: /Pn.
The range for legal arguments to the /P option is 0 thru 7.
12. Illegal argument in CP option: /Tn.
The range for legal arguments to the /T option is 0 thru 8.
13. Illegal argument in CP option: /Vn.
The range for legal arguments to the /V option is 0 thru 8.
14. Illegal argument in CP option: /Wn.
The range for legal arguments to the /W option is 1.0 thru
18.0.
15. Illegal argument in CP option: /Yn.
The range for legal arguments to the /Y option is 0 thru 2.
16. No extension supplied in source file name.
A file name extension must be supplied for the source file
name.
17. Unrecognized source file extension.
The recognized source file extensions for the C language are
".c", ".cpp", ".h" and ".hpp".
18. Unrecognized CP option: <option>.
The recognized CP options are: /A /Bn /C /D /E /F /Gn /H /I
/Jn /Kn /L /Mn /N /O /Pn /Q /R /S /Tn /U /Vn /Wn /X /Yn /Z.
19. Print executive/com file not found.
To enable printing, CodePrint requires that PRINT.EXE or
PRINT.COM be located in the DOS directory, C:\DOS, or the
main directory, C:\.
20. Too many bytes per line.
CodePrint cannot process source files with more than 512
bytes per line.
21. Too many tokens per line.
CodePrint cannot process source files with more than 250
tokens per line.
User Manual Page 23 of 30
Geist Microsystems CodePrint for C/C++
22. Keyword file not found: <keyword file>.
The keyword file does not exist.
23. Too many keywords in keyword file: <keyword file>.
CodePrint cannot process keyword template files with more
than 250 keyword entries.
24. Source listing file not found: <source listing file>.
The source listing file does not exist.
25. Too many source files: <number of source files>.
CodePrint cannot process more than 100 source files in batch
mode.
26. Print queue is full.
CodePrint uses the DOS PRINT command to process source files
in batch mode. The number of files CodePrint can process
at any one time is limited to the number of files specified
in the PRINT /Q:queuesize command. Legal values range from
0 to 32. The default is 10.
27. Disk is full.
CodePrint cannot write output to the hard drive because the
disk is full. You can remedy this by freeing up space on
your hard drive.
28. The CP environment variable has not been set.
This variable is set when you install the software. The
installation procedure stores this value in CPINI.BAT. You
can also set environment variables from the DOS command line
with SET CP=<options>.
29. The CPDRIVE environment variable has not been set.
This variable is set when you install the software. The
installation procedure stores this value in CPINI.BAT. You
can also set environment variables from the DOS command
line with SET CPDRIVE=<destination drive>.
30. The HP environment variable has not been set.
This variable is set when you install the software. The
installation procedure stores this value in CPINI.BAT. You
can also set environment variables from the DOS command line
with SET HP=<options>.
User Manual Page 24 of 30
Geist Microsystems CodePrint for C/C++
31. The FORMFEED environment variable has not been set.
This variable is set when you install the software. The
installation procedure stores this value in CPINI.BAT. You
can also set environment variables from the DOS command line
with SET FORMFEED=<options>.
32. Unbalanced parentheses.
This indicates a syntax error in the source code.
33. Unbalanced braces.
This indicates a syntax error in the source code.
34. IF without ELSE.
This indicates a syntax error in the source code.
User Manual Page 25 of 30
Geist Microsystems CodePrint for C/C++
INDEX
- A -
/a, 11, 18, 23
A4, 7
ANSI, 14
ASP, 3
autoindent, 1, 11, 12, 14, 16, 18, 21
- B -
/b, 11, 18, 22, 23
batch processing, 2, 19
Borland, 14
- C -
/c, 11, 18, 22, 23
C++, 1, 3, 9, 19
carriage width, 16
command syntax, 9
compressed, 1, 11, 13, 18
CP, 5, 9, 10, 11, 19, 22, 23, 24
CPDRIVE, 5, 24
- D -
/d, 12, 18, 23
Diablo, 3, 11, 13
DOS 3, 22
doublestrike, 1, 11, 13, 15, 16, 18
- E -
/e, 12, 18, 23
emphasized, 1, 12, 13, 15, 16, 18
Epson, 3, 11, 13
error messages, 1, 22
executive, 7
- F -
/f, 12, 18, 23
file specification, 9
flow lines, 12, 16, 18
form feed, 1, 8, 16, 18, 24
- G -
/g, 12, 16, 18, 22, 23
User Manual Page 26 of 30
Geist Microsystems CodePrint for C/C++
- H -
/h 13, 18, 23
header, 1, 4, 13, 16, 18
HP, 3, 5, 7, 11, 12, 13, 24
- I -
/i, 13, 18, 23
IBM, 3, 11, 13, 15
indent style, 17, 18
installation, 3, 5
italics, 13, 18, 23
- J -
/j, 13, 18, 22, 23
justification, 13, 18
- K -
/k, 14, 18, 22, 23
K&R, 17
keyword template, 1, 14, 18, 21
- L -
/l, 14, 18, 23
landscape, 7, 12, 13
legal, 7
letter, 7
license, 3
line numbers, 1, 4, 14, 16, 18
local area network, 2, 6
- M -
/m, 14, 18, 22, 23
margins, 1, 14, 16, 18
Microsoft, 14
- N -
/n, 14
NEC, 3, 11, 13
- O -
/o, 15, 18, 23
on-line help, 1, 19
options, 15, 18
User Manual Page 27 of 30
Geist Microsystems CodePrint for C/C++
- P -
/p, 15, 18, 23
packing list, 3
page breaks, 1, 4, 11, 16, 18
page numbers, 1, 4, 16, 18
paper size, 7
pretty printer, 1, 3, 4, 7, 19
portrait, 7, 12, 13
print queue, 6, 20, 24
printer configuration, 12
printer port, 15
product support, 3
- Q -
/q, 15, 18, 23
quickprint, 15, 18
Qume, 3, 11, 13, 18
- R -
/r, 18, 23
reformat, 1, 16, 18, 20
registration, 3
- S -
/s, 16, 18, 23
SET, 5, 7, 8, 10, 24
shareware, 3
site license, 3
spaces, 16
spooling, 2, 6, 19, 20
symbol set, 5, 7, 24
syntax errors, 4
- T -
/t, 16, 18, 22, 23
tab conversion, 16, 18
tab spacing, 16, 18
- U -
/u, 23
underline, 11, 13, 15, 16, 18
- V -
/v, 16, 18, 22, 23
vendor, 3
User Manual Page 29 of 30
Geist Microsystems CodePrint for C/C++
- W -
/w, 16, 18, 22, 23
warranty, 3
whitespace, 1
wild cards, 2, 19
- X -
/x, 16, 18, 23
- Y -
/y, 17, 18, 22, 23
- Z -
/z 12, 23
User Manual Page 30 of 30